home *** CD-ROM | disk | FTP | other *** search
/ Giga Pack / Giga Pack CD1.iso / cards / calc110 / calc.doc < prev    next >
Text File  |  1991-10-28  |  20KB  |  529 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   Calculation
  10.  
  11.                                   Version 1.10
  12.  
  13.                                Copyright 1991 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?     ___________
  21.  
  22.         Calculation, also known as "Broken Intervals", is a solitaire card
  23.         game that requires the utmost in skill and logic.  It offers
  24.         challenging but rewarding play, and special on-screen assistance to
  25.         make it easier to play.
  26.  
  27.  
  28.      Program Requirements     ____________________
  29.  
  30.         Calculation requires 256K of memory, EGA or higher graphics
  31.         capability, and a Microsoft-compatible mouse.  If you are not sure
  32.         you have the right hardware, just run the program.  If there's a
  33.         problem, the program will let you know.
  34.  
  35.         In addition to the program file (CALC.EXE), the game requires that
  36.         the card definition files (CARDS.CD1 and CARDS.CD2) be in the
  37.         current directory.  These files contain the bit-maps for each
  38.         cardface in the deck.
  39.  
  40.  
  41.      Using The Mouse     _______________
  42.  
  43.         The mouse pointer will appear as a white arrow with black edges.
  44.         In general, the left button is used to select the object being
  45.         pointed to (a card or an on-screen button), while the right button
  46.         is used to exit menus or prompts.
  47.  
  48.         If you have a three-button mouse, the middle button will blank the
  49.         screen.  This can also be accomplished by pressing the left and
  50.         right buttons simultaneously.
  51.  
  52.  
  53.      How To Play     ___________
  54.  
  55.         Calculation uses a standard 52-card deck (no jokers).  To begin the
  56.         game the deck is shuffled, then any ace, two, three, and four are
  57.         pulled from the deck and form the start of four foundations.  These
  58.         foundations are built up according to the following sequence,
  59.         regardless of suit or color:
  60.  
  61.                             A,2,3,4,5,6,7,8,9,10,J,Q,K
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Calculation Documentation                                       Page 2
  72.  
  73.  
  74.                             2,4,6,8,10,Q,A,3,5,7,9,J,K
  75.                             3,6,9,Q,2,5,8,J,A,4,7,10,K
  76.                             4,8,Q,3,7,J,2,6,10,A,5,9,K
  77.  
  78.         Cards are turned up from the deck on at a time, and can be played
  79.         on the foundations or on any of four wastepiles located just below
  80.         the foundations.  The top of the wastepiles are always available
  81.         for play to a foundation, but once a card is played to a wastepile,
  82.         it cannot be moved again, except to a foundation.
  83.  
  84.         The game is won by building all four foundations up to king.  The
  85.         skill involved in playing Calculation, in addition to just keeping
  86.         track of what card goes next on each foundation, is in avoiding
  87.         covering up a card you'll need soon with a card that cannot be used
  88.         for some time, if at all.  Kings are especially troublesome, since
  89.         they cannot be moved until at least one foundation has been fully
  90.         built up.
  91.  
  92.         The general strategy is to build on the wastepiles in descending
  93.         order, but the cards are seldom so kind as to allow this to any
  94.         great degree.
  95.  
  96.  
  97.      Buttons     _______
  98.  
  99.         Along the right side of the screen are a number of "buttons", which
  100.         may be selected by pointing and clicking with the mouse.  The
  101.         buttons are:
  102.  
  103.            Options: This button brings up the options menu, which you can
  104.               use to set your preferences for the following:
  105.  
  106.               Sound: Select "Off" to disable the beeps, clicks, and various
  107.                  other noises the program makes.  Select "On" to enable the
  108.                  sounds.
  109.  
  110.               Assist: When this is set "On" the next card in each sequence
  111.                  will be displayed above each foundation to help you keep
  112.                  track of what comes next.
  113.  
  114.               Session Statistics: When this option is set to "On", the
  115.                  program will keep track of your statistics (games played,
  116.                  games won, change in average score) throughout the game
  117.                  and then display them when you quit.  (Note: During play,
  118.                  you can also display the session statistics by clicking on
  119.                  the score box.)
  120.  
  121.               Background Color: Click on the up-arrow and down-arrow to
  122.                  step through the available background colors, until you
  123.                  find one that suits your tastes.
  124.  
  125.               Card Back: Click on the up-arrow and down-arrow to cycle
  126.                  through the available card designs until you find one you
  127.                  like.  You can also click on the card back itself to bring
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Calculation Documentation                                       Page 3
  138.  
  139.  
  140.                  up a dialog box which will show you all the available card
  141.                  backs and allow you to choose one.
  142.  
  143.               Once you've set things to your liking, you may click on the
  144.               "OK" button to save your preferences to disk, or on the
  145.               "Cancel" button to exit the Options menu without changing
  146.               anything.
  147.  
  148.            Help: This button will bring up several pages of help screens,
  149.               which you can view by clicking on the "Next" or "Prev"
  150.               buttons to move from page to page.  When you are finished
  151.               reading the help, click on the "Done" button to exit.
  152.  
  153.            New Game: This button will end the current game, update your
  154.               statistics, and start a new game.
  155.  
  156.            Quit: Click on this button to exit the program.  If you have a
  157.               score greater than four, your statistics will be updated and
  158.               displayed briefly before returning you to DOS.  Another way
  159.               to exit the game is to press the "Abort" key (F10).  If you
  160.               press F10 (and select the "Exit This Program" option in the
  161.               pop-up dialog box or press F10 again), the program will quit
  162.               to DOS without saving the data file (and thus not giving you
  163.               a low score if you have to quit the program in the middle of
  164.               a game).  Of course you realize this is cheating, don't you?
  165.  
  166.  
  167.      Command-Line Options     ____________________
  168.  
  169.         /LCD -- This option may improve the screen display on monochrome
  170.                 LCD displays.  This option simply changes a few color
  171.                 combinations to improve contrast on LCDs.
  172.  
  173.         /Rxxxxxx -- This option is used to convert a shareware version of
  174.                     the program to a registered version.  Refer to "A Note
  175.                     To Registered Users" at the end of this document for
  176.                     more information.
  177.  
  178.         /SW -- This option is used to convert a registered version to a
  179.                shareware version.
  180.  
  181.         filename.ext -- This option is for alternate data files (see
  182.                         discussion below).
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      Calculation Documentation                                       Page 4
  204.  
  205.  
  206.      Statistics     __________
  207.  
  208.         Calculation keeps track of the score (the number of cards you've
  209.         played to the foundations), the total number of games you've
  210.         played, the number of games you've won (expressed as both a number
  211.         and a percentage), and your average score.  At the end of each
  212.         game, the statistics are written to disk, either in the default
  213.         CALC.DAT or in the data file specified on the command line.  The
  214.         data file also contains the preferences you set in the options menu
  215.         (sound on/off and background color).
  216.  
  217.         To specify a data file on the command line, start up Calculation
  218.         with the following syntax:
  219.  
  220.                                  CALC filename.ext
  221.  
  222.         This allows several different people to use the same copy of
  223.         Calculation on the same machine, yet keep separate statistics for
  224.         each person.  For example, suppose three people (Tom, Dick, and
  225.         Harry) played the game at various times on the same machine.  They
  226.         could each easily keep personalized data files, containing their
  227.         scores and preferences for sound and background color.  Tom would
  228.         use his data file by typing:
  229.  
  230.                                    CALC TOM.DAT
  231.  
  232.         Likewise, Dick and Harry could have data files called DICK.DAT and
  233.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  234.         or whatever, as long as it is three letters or less.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      Calculation Documentation                                       Page 5
  270.  
  271.  
  272.      Legalese     ________
  273.  
  274.         Calculation is shareware.  As such, you can play it, copy it, and
  275.         give it away as you wish.  In fact, you are encouraged to
  276.         distribute the program to friends, family, and strangers alike.
  277.         This includes distribution via electronic bulletin board systems
  278.         (BBS), user's groups, and disk-distribution services.  All that I
  279.         ask is that the program remain unaltered, and be distributed in an
  280.         archive consisting of:
  281.  
  282.            CALC.EXE ............. the program
  283.            CALC.DOC ............. documentation
  284.            CARDS.CD1 ............ card definition file #1
  285.            CARDS.CD2 ............ card definition file #2
  286.  
  287.  
  288.      Registration     ____________
  289.  
  290.         Calculation is shareware.  If you enjoy the game, please support
  291.         it.  There are three registration packages available:
  292.  
  293.            1. Basic Registration ................................... $5.00
  294.  
  295.               This minimum registration will get you the latest registered
  296.               (no shareware "beg" message) version of Calculation on a
  297.               diskette of your choice, along with a registration code good
  298.               for all future updates.
  299.  
  300.            2. Package Deal #1 ..................................... $10.00
  301.  
  302.               This package consists of the latest registered version of
  303.               Calculation, plus shareware versions of my other games, along
  304.               with a menu program to tie them all together.  Note that all
  305.               of the additional programs are unregistered versions (with
  306.               shareware "beg" screens).  You will also receive a
  307.               registration code good for all future updates of Calculation.
  308.  
  309.            3. Package Deal #2 ..................................... $15.00
  310.  
  311.               This package consists of the latest registered versions of
  312.               Calculation, plus registered versions of my other games,
  313.               along with a menu program to tie them all together.  Note
  314.               that all of the additional programs are fully registered
  315.               versions (no shareware "beg" screens).  You will also receive
  316.               registration codes good for all future updates of Calculation
  317.               and the other programs.
  318.  
  319.         Basic registration is available on a 5.25", 360K disk or on a
  320.         3.50", 720K disk.  The package deals are available on two 360K
  321.         disks (with the programs ZIPped (with the PKZIP compression
  322.         program) to pack as much as possible onto each disk), one 720K disk
  323.         (ZIPped), or one 5.25", 1.2M disk.  If you do not have access to
  324.         PKZIP, you'll need to order the package deals on a 1.2M disk.
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      Calculation Documentation                                       Page 6
  336.  
  337.  
  338.         No matter what option you choose, you'll be getting a lot of
  339.         quality software for just a little dough.  Please consider
  340.         registering.
  341.  
  342.         The programs that you will get with the package deals are:
  343.  
  344.            Midnight Oil: An EGA solitaire card game, otherwise known as La
  345.               Belle Lucie and Three Shuffles and a Draw.  In this game the
  346.               deck is dealt into seventeen fans of three cards each.  Cards
  347.               are moved from the fans to four foundations, which are then
  348.               built up in suit from Ace to King.  Midnight Oil is one of
  349.               the best solitaires, affording great opportunity for skillful
  350.               play.  The game keeps statistics in a disk file, and has a
  351.               special auto mode that makes the game especially easy to
  352.               play.
  353.  
  354.            Monte Carlo: An EGA-based solitaire card game in which you try
  355.               to remove pairs of cards from a 5 x 5 matrix.  This easy-to-
  356.               play game offers hours of relaxing fun.  It keeps statistics
  357.               in much the same way as Calculation, has selectable card
  358.               designs, and a "hint" button that makes the game especially
  359.               easy to learn.
  360.  
  361.            Osmosis: In this EGA solitaire card game you have four
  362.               foundations to build, but a card can only be played to a
  363.               lower foundation if it has also been played to an upper
  364.               foundation.  This addictive game is simple to play but
  365.               difficult to win, with success often depending as much on
  366.               luck as skill.  It keeps statistics on-disk, offers
  367.               selectable card backs and has a "peek" option to give you an
  368.               extra edge.
  369.  
  370.            Idiot's Delight: An EGA version of "Aces Up", a simple but
  371.               addictive game of luck and skill.  This is one of those games
  372.               that leave you saying "just one more game" time after time
  373.               after time.  As in my other EGA games, it keeps a statistic
  374.               file and offers selectable card backs.
  375.  
  376.            Royal Cotillion: This is a two-deck EGA solitaire in which you
  377.               must build up eight foundations in suit by twos.  It offers
  378.               good opportunity for skillful play, a pleasing layout, and
  379.               hours of engrossing fun.  It keeps a statistics file, has
  380.               selectable card backs, and a time-saving auto mode.
  381.  
  382.            Concentration: An EGA graphics version of the classic memory-
  383.               stretching solitaire.  It keeps a statistics file, features
  384.               selectable card backs, and offers a unique multi-player mode.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.      Calculation Documentation                                       Page 7
  402.  
  403.  
  404.         You can print the registration form from the initial shareware
  405.         screen.  Simply select the "Print Registration Form" button, then
  406.         select a destination, either to a printer or a file.  If you elect
  407.         to send the form to a printer, make sure it is on-line and ready.
  408.         The form should print on any standard 80-column printer.  If you
  409.         want to save the form to a file, the file "CALC.FRM" will be
  410.         created in the current directory.  You can then print out the
  411.         registration form by entering the following command from the DOS
  412.         prompt (with your printer connected and ready):
  413.  
  414.                                  COPY CALC.FRM PRN
  415.  
  416.         Then just fill out the form and send it, along with cash, check or
  417.         money order, to:
  418.  
  419.                                     Randy Rasa
  420.                                    18215 Troost
  421.                                  Olathe, KS 66062
  422.  
  423.  
  424.  
  425.  
  426.      Revision History     ________________
  427.  
  428.         1.00  01-03-91  First Public Release.
  429.         1.01  01-11-90  Added "Session Statistics" option.
  430.                         Cosmetic changes.
  431.         1.02  02-15-91  More cosmetic changes.
  432.         1.03  03-12-91  Added registration procedure.
  433.         1.04  03-23-91  Modified registration procedure.
  434.         1.05  04-23-91  Added option to print registration form.
  435.                         Changed card definition filenames to CARDS.CD*.
  436.         1.06  05-17-91  Fixed problem with equipment test.
  437.         1.07  07-01-91  Added Abort (F10) feature.
  438.                         The program now exits to DOS after running the
  439.                         registration procedure, and the program date and
  440.                         time are set correctly.
  441.         1.08  08-21-91  Added /LCD command-line switch.
  442.                         Added /M command-line switch.
  443.                         Clear message line for Help and Options menus.
  444.         1.09  09-02-91  Rewrote mouse initialization routine.
  445.                         Removed /M command-line switch.
  446.         1.10  10-28-91  Added dialog box to select card back.
  447.                         Improved parsing of command-line arguments.
  448.                         Modified the "abort" sequence so that pressing F10
  449.                         once will bring up the abort dialog box, and
  450.                         pressing F10 again will exit the program.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.      Calculation Documentation                                       Page 8
  468.  
  469.  
  470.      A Note To Registered Users     __________________________
  471.  
  472.         The registration procedure allows previously-registered users to
  473.         update to the new registered version of the program by entering a
  474.         special 'registration code' that was included as part of your
  475.         order.  Run the shareware version of the program with the "/R"
  476.         command-line switch, followed by the registration code, like this:
  477.  
  478.            CALC /Rxxxxxx
  479.  
  480.         You would, of course use the proper registration code in place of
  481.         the "xxxxxx".  Note also that there should be no space between the
  482.         "R" and the registration code.  After running the program with /R
  483.         switch and the proper code, you'll have a brand-spanking new
  484.         registered version of the program.  What this essentially amounts
  485.         to is unlimited, free updates with each registration.
  486.  
  487.         The registration procedure comes with the following limitations:
  488.  
  489.            1. The name your EXE file must be CALC.EXE.
  490.  
  491.            2. You cannot perform the registration procedure on a compressed
  492.               version (ie: an EXE file processed with PKLite, Diet, or
  493.               LZEXE).  The EXE file may be compressed after the
  494.               registration procedure, but not before.
  495.  
  496.            3. Please do not distribute registered versions of the program.
  497.  
  498.            4. Since the registration procedure is a new feature, there are
  499.               a number of people who have registered earlier versions that
  500.               won't be able to take advantage of it just yet.  But if you
  501.               send me a self-addressed stamped envelope, I'll be happy to
  502.               send you the registration code.
  503.  
  504.  
  505.         Note: You can also change the program back to the shareware version
  506.               by using the "/SW" command-line switch.  This function is
  507.               subject to the same limitations as with the registration
  508.               procedure (ie: the program must be properly named and
  509.               uncompressed).  Please use this option to "un-register" the
  510.               program if you wish to pass it along to anyone.  Also, please
  511.               include all of the files listed under the "Legalese" section
  512.               of this document.  Thanks.
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.